home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / tosfixes / serialfx.zoo / serialfx.doc < prev    next >
Text File  |  1992-05-27  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  Serial Fix © 1992
  8.                             by Medical Designs Software
  9.                                     Version 1.00
  10.  
  11.          Written by: Bill Penner
  12.          Icons created by: Bruce D. Noonan, M.D.
  13.  
  14.  
  15.                This program  may  be  distributed and used, free of charge,
  16.          provided  that  the  program  is  distributed in complete form and
  17.          UNmodified.   This  software  is  not  to be sold, however, may be
  18.          included  on  disks  which  are  sold  for  a small handling fee.
  19.          Medical  Design  Software  retains  all copyright exclusive rights
  20.          except  exclusive  distribution.   This  software  consists of the
  21.          following  files:  SERIALFX.PRG,  SERIALFX.CPX,  and  SERIALFX.DOC
  22.          (this file).
  23.  
  24.          PURPOSE
  25.  
  26.               Serial  Fix  was  written  as  an upgrade to the old TurboCTS
  27.          program,  written  by  Bill Penner, long ago, as an attempt to fix
  28.          the  old  RTS/CTS  problem.  The problem the ST/STe/TT has, occurs
  29.          when  a high speed modem is used in conjunction with ZMODEM or any
  30.          near-continuous  flow  transfer program is used to send data.  The
  31.          ST/TT  sometimes  has problems properly recognizing when the modem
  32.          deasserts CTS (telling the ST/TT that the buffer is full and don't
  33.          send  any  more data), resulting in the ST overflowing the modem's
  34.          buffer.   This results in bad data being sent which results in CRC
  35.          errors, packet size problems, and other data transmission errors.
  36.  
  37.               TurboCTS was only a partial fix of the problem.  TurboCTS did
  38.          manage  to  speed  things  up  to the point where CTS response was
  39.          generally  ok,  however,  that program did not work on the TT, did
  40.          not  support  XBRA  programming  requirements, and only worked for
  41.          RTS/CTS handshaking.
  42.  
  43.               Serial  FIX  is a replacement for TurboCTS and will work with
  44.          all  versions of TOS (1.0 through 3.06).  Serial FIX supports FOUR
  45.          forms of handshaking:  (1) XON/XOFF, (2) RTS/CTS, (3) BOTH RTS/CTS
  46.          AND  XON/XOFF,  and (4) NONE.  The desired handshaking mode is set
  47.          from  the RS232 control panel or other program as you currently do
  48.          now.   The new fix is a REAL fix to the RTS/CTS problem.  Previous
  49.          fixes  (like  TurboCTS)  only  fixed the symptoms of the problem.
  50.          NOTE:   Although  documented  as legal in official Atari bindings,
  51.          TOS  normally  will  NOT allow both XON/XOFF and RTS/CTS to be set
  52.          simultaneously.  Serial FIX DOES support this option, however.
  53.  
  54.          INSTALLATION:
  55.  
  56.               Serial  FIX  is composed of two parts, a program for the AUTO
  57.          folder  and  a  CPX  file  to  be used with the extensible CONTROL
  58.          (XCONTROL.ACC) panel.
  59.  
  60.               SERIALFX.PRG  is  the  heart  of  the  Serial  FIX solution.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.          SERIALFX.PRG  is  intended  to  be  installed in your AUTO folder,
  74.          although  it can be ran from the desktop, and replaces the current
  75.          serial  routines  for  the  ST compatible port.  The ST compatible
  76.          port  is  the only port on the ST and STe machines, or the Modem 1
  77.          port (ONLY!) on the MegaSTe and TT machines.
  78.  
  79.               SERIALFX.CPX   is  a  control  panel  to  be  used  with  the
  80.          Extensible  Control Panel (XCONTROL.ACC).  The CPX is used to lock
  81.          the  serial  routines  into  using  at  least RTS/CTS handshaking,
  82.          regardless  of the desires of a program to the contrary.  The file
  83.          SERIALFX.CPX is to be placed in in your folder of CPX files (often
  84.          called 'CPX').
  85.  
  86.          OPERATION:
  87.  
  88.               SERIALFX.PRG:   Once  the  program  has  been started (either
  89.          booted  in  the 'AUTO' folder or run from the desktop), no special
  90.          operations  are  needed.  The program replaces the system routines
  91.          and  the  port speed and handshaking are set just as they are now,
  92.          either  by  terminal  software,  CONTROL  panel, or the Extensible
  93.          Control Panel.
  94.  
  95.               SERIALFX.CPX:   This  program  will  allow  you  to  lock the
  96.          handshaking  in  RTS/CTS  mode.   This  is  often needed because a
  97.          number  of programs have been written to ignore RTS/CTS mode (like
  98.          FLASH).   If  the CPX is not used to lock the mode on, and RTS/CTS
  99.          mode  is  SET  from  the  control panel, AND a terminal program is
  100.          started,  very  likely,  the program would turn off RTS/CTS.  With
  101.          the  mode  locked, the program will be unable to disable RTS/CTS.
  102.          The CPX will give you the option to save the current lock setting.
  103.          Saving  the  setting  will  cause  the selected mode to be entered
  104.          every  time  the  CPX  boots  up.   NOTE:   to be able to lock the
  105.          RTS/CTS  mode  on,  you  must  use  BOTH  THE SERIALFX.PRG AND THE
  106.          SERIALFX.CPX.
  107.  
  108.          PROGRAMMING INFORMATION:
  109.  
  110.               This  version  of  the  software  should  now  be  fully XBRA
  111.          compliant.   When the software starts and installs the replacement
  112.          routines,  the TOS version is checked to determine the best method
  113.          of installation (read for maximum speed).  Under TOS 1.0, traps 1,
  114.          13, and 14 are intercepted and processed.  Under TOS 1.2, 1.4, and
  115.          1.6 (non-Bconmap() compatible machines after 1.2), the xcon vector
  116.          table is used, and only trap 14 is used to receive Rsconf() calls.
  117.          Under  Bconmap()  compatiable  systems,  bconmap (port 6) and xcon
  118.          vectors are modified so that no trap interception is necessary.
  119.  
  120.               Other  software  can  be  used  to  lock or unlock the serial
  121.          routines.   To perform this function, look in the cookie jar for a
  122.          'MDSa'  cookie.   The long data byte is a pointer to the following
  123.          data structure:
  124.  
  125.              struct {
  126.                      int   lockfg;         /*  RTS/CTS locked flag (bit 1 =
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          locked) */
  140.                      int   (*setlock)()    /*  Routine  to  set lock status
  141.          */
  142.                     } serfx;
  143.  
  144.          The  lock  status  is  set by pushing an integer with the value of
  145.          either  0  (to disable lock) or 1 (to enable) and then jsr'ing the
  146.          setlock  routine  (i.e. (*serfx->setlock)(1) to enable the lock).
  147.          The  call can be made in user or super mode.  That is all there is
  148.          to it.
  149.  
  150.          WRAP UP
  151.  
  152.               As  normal,  PLEASE let me know if you have any problems with
  153.          the  program.   I have attempted to make the program as compatible
  154.          with other software as possible.
  155.  
  156.  
  157.          Bill Penner, IAAD Member
  158.          3235 Wright Avenue
  159.          Bremerton, WA  98310-4753
  160.  
  161.          Phone: (206) 373-4840 (before 9pm Pacific)
  162.          GEnie: BPENNER
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.